package com.kurt.service;

import com.kurt.dto.LoginRequest;
import com.kurt.dto.LoginResponse;
import com.kurt.dto.UserDTO;
import com.kurt.dto.create.UserCreateRequest;
import com.kurt.dto.query.UserQueryRequest;
import com.kurt.dto.update.UserUpdateRequest;
import com.kurt.entity.SysUser;
import org.springframework.data.domain.Page;

import java.util.List;

/**
 * 用户服务接口
 * 提供用户相关的业务逻辑方法
 */
public interface UserService extends BaseService<SysUser, Long> {

    /**
     * 用户登录
     *
     * @param loginRequest 登录请求
     * @return 登录响应
     */
    LoginResponse login(LoginRequest loginRequest);

    /**
     * 用户登出
     *
     * @param token 访问令牌
     * @return 是否成功
     */
    boolean logout(String token);

    /**
     * 创建用户
     *
     * @param createRequest 创建请求
     * @return 用户信息
     */
    UserDTO createUser(UserCreateRequest createRequest);

    /**
     * 更新用户
     *
     * @param updateRequest 更新请求
     * @return 用户信息
     */
    UserDTO updateUser(UserUpdateRequest updateRequest);

    /**
     * 根据ID获取用户详情
     *
     * @param id 用户ID
     * @return 用户信息
     */
    UserDTO getUserById(Long id);

    /**
     * 分页查询用户
     *
     * @param queryRequest 查询请求
     * @return 分页结果
     */
    Page<UserDTO> getUserPage(UserQueryRequest queryRequest);

    /**
     * 根据条件查询用户列表
     *
     * @param queryRequest 查询请求
     * @return 用户列表
     */
    List<UserDTO> getUserList(UserQueryRequest queryRequest);

    /**
     * 删除用户
     *
     * @param id 用户ID
     * @return 是否成功
     */
    boolean deleteUser(Long id);

    /**
     * 批量删除用户
     *
     * @param ids 用户ID列表
     * @return 是否成功
     */
    boolean deleteUsers(List<Long> ids);

    /**
     * 重置用户密码
     *
     * @param id          用户ID
     * @param newPassword 新密码
     * @return 是否成功
     */
    boolean resetPassword(Long id, String newPassword);

    /**
     * 修改用户密码
     *
     * @param id          用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @return 是否成功
     */
    boolean changePassword(Long id, String oldPassword, String newPassword);

    /**
     * 分配用户角色
     *
     * @param userId  用户ID
     * @param roleIds 角色ID列表
     * @return 是否成功
     */
    boolean assignRoles(Long userId, List<Long> roleIds);

    /**
     * 获取用户角色列表
     *
     * @param userId 用户ID
     * @return 角色列表
     */
    List<UserDTO.RoleDTO> getUserRoles(Long userId);

    /**
     * 获取用户权限列表
     *
     * @param userId 用户ID
     * @return 权限列表
     */
    List<String> getUserPermissions(Long userId);

    /**
     * 根据账号查找用户
     *
     * @param account 账号
     * @return 用户信息
     */
    UserDTO getUserByAccount(String account);

    /**
     * 检查账号是否存在
     *
     * @param account 账号
     * @return 是否存在
     */
    boolean existsByAccount(String account);

    /**
     * 检查手机号是否存在
     *
     * @param phone 手机号
     * @return 是否存在
     */
    boolean existsByPhone(String phone);

    /**
     * 根据组织ID获取用户列表
     *
     * @param organizationId 组织ID
     * @return 用户列表
     */
    List<UserDTO> getUsersByOrganizationId(Long organizationId, Long currentUserId);

    /**
     * 根据角色ID获取用户列表
     *
     * @param roleId 角色ID
     * @return 用户列表
     */
    List<UserDTO> getUsersByRoleId(Long roleId, Long currentUserId);
}
